home *** CD-ROM | disk | FTP | other *** search
/ SGI Performance Co-Pilot 1.3 / SGI Performance Co-Pilot 1.3.iso / dist / dist6.4 / pcp.idb / usr / share / catman / u_man / cat3 / PMAPI / _pmfindpmda.z / _pmfindpmda
Text File  |  1997-04-03  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. ____PPPPMMMMFFFFIIIINNNNDDDDPPPPMMMMDDDDAAAA((((3333))))                                                  ____PPPPMMMMFFFFIIIINNNNDDDDPPPPMMMMDDDDAAAA((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ____ppppmmmmFFFFiiiinnnnddddPPPPMMMMDDDDAAAA - search for the filename of a PMDA
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////ppppmmmmaaaappppiiii....hhhh>>>>
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppccccpppp////iiiimmmmppppllll....hhhh>>>>
  14.  
  15.      cccchhhhaaaarrrr ****____ppppmmmmFFFFiiiinnnnddddPPPPMMMMDDDDAAAA((((cccchhhhaaaarrrr ****nnnnaaaammmmeeee))))
  16.  
  17.      cccccccc ............ ----llllppppccccpppp
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      Given the _n_a_m_e of a PMDA (may be a DSO PMDA or a daemon PMDA), search for
  21.      a file of that name in a number of well known places.
  22.  
  23.      If _n_a_m_e exists, ____ppppmmmmFFFFiiiinnnnddddPPPPMMMMDDDDAAAA returns immediately.  Otherwise, a search is
  24.      conducted.
  25.  
  26.      If _n_a_m_e is an absolute path (i.e. begins with ``/''), then the only
  27.      searching involves the equivalence of /_u_s_r/_p_c_p/_l_i_b and /_v_a_r/_p_c_p/_l_i_b.  If
  28.      _n_a_m_e begins with either of these prefixes, then the name formed by
  29.      translating _n_a_m_e to use the other prefix is checked.
  30.  
  31.      If _n_a_m_e is a relative path (i.e. does nnnnooootttt begin with ``/''), then
  32.      searching involves scanning each directory in the colon ``:'' separated
  33.      list defined by the value of the environment variable PPPPMMMMDDDDAAAA____PPPPAAAATTTTHHHH.  If
  34.      PPPPMMMMDDDDAAAA____PPPPAAAATTTTHHHH is not set, the default search path is
  35.      ``/var/pcp/lib:/usr/pcp/lib''.
  36.  
  37.      The return value is NULL if the search fails, otherwise the path to the
  38.      PMDA file is returned.  For success without searching, the return value
  39.      is _n_a_m_e, otherwise, the return value is the address of a static buffer
  40.      within ____ppppmmmmFFFFiiiinnnnddddPPPPMMMMDDDDAAAA.
  41.  
  42. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  43.      ppppmmmmccccdddd(1), PPPPMMMMAAAAPPPPIIII(3) and ppppmmmmNNNNeeeewwwwCCCCoooonnnntttteeeexxxxtttt(3).
  44.  
  45. CCCCAAAAVVVVEEEEAAAATTTT
  46.      ____ppppmmmmFFFFiiiinnnnddddPPPPMMMMDDDDAAAA searches for a file base on the supplied _n_a_m_e.  Success is
  47.      defined by existence of a file with the matching name, according to the
  48.      search algorithm.  In the case of a successful search, the resultant file
  49.      may not be a PMDA at all, and a subsequent attempt to ddddllllooooppppeeeennnn(3) or
  50.      eeeexxxxeeeecccc(2) this file may well fail.
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.